LiveCode 8.1.2 Release Notes 12/19/16 
LiveCode 8.1.2 Release Notes 


e Overview 
e Known issues 
e Platform support 


o Windows 
o Linux 

o Mac 

° iOS 

o Android 
o HTML5 


o Installation 

o Uninstallation 

o Reporting installer issues 

° Activating LiveCode Indy or Business edition 

© Command-line installation 

© Command-line uninstallation 

© Command-line activation for LiveCode Indy or Business edition 


e Engine changes 


° Improved ul TraceLocals output (8.1.2-rc-1) 

o Fix problems with printing PDFs to some printers (8.1.2-rc-1) 
°o Specific engine bug fixes (8.1.2-rc-3) 

° Specific engine bug fixes (8.1.2-rc-2) 

° Specific engine bug fixes (8.1.2-rc-1) 


IDE changes 


© Specific IDE bug fixes (8.1.2-rc-2) 
o Specific IDE bug fixes (8.1.2-rc-1) 


e LiveCode extension changes 
° Specific extension bug fixes (8.1.2-rc-1) 


e Previous release notes 


(ON Z=TaVi T=" 
LiveCode 8.1 provides important improvements for delivering high-quality cross-platform 
applications! 


e LiveCode Indy and Business editions now come with the tsNet external, which supercharges 
LiveCode's Internet features and performance. LiveCode 8.1 also introduces mergHealthkit, 
for accessing activity, sport and health data on iOS devices. 


e The standalone builder now has a greatly-improved user experience for including externals, 


LiveCode 8.1.2 Release Notes 12/19/16 


script libraries and LiveCode Builder extensions in your cross-platform application. Usually, 
it'll now do the right thing automatically, but you can still select the specific inclusions you 
need. 


e The IDE has lots of other upgrades, too: a keyboard-navigable Project Browser that 
highlights any scripts that failed to compile, an improved dictionary user interface, and 
access to the message box just by starting to type. 


e The player control can be used in Windows application without any need for users to install 
any additional libraries or dependencies, thanks to a brand new player implementation 
based on DirectShow. For most apps, it should now be unnecessary to install or use 
QuickTime at all. 


e The LiveCode Builder programming language has had some enhancements as part of the 
Infinite LiveCode project. Variables now get initialised by default, unsafe blocks and 
handlers can be used to flag sections of code that do dangerous things, and you can even 
include raw bytecode if necessary. 


Known | < 


e The installer will currently fail if you run it from a network share on Windows. Please copy the 
installer to a local disk before launching on this platform. 


e The browser widget does not work on 32-bit Linux. 


e 64-bit standalones for Mac OS X do not have support for audio recording or the 
revVideoGrabber external. 


The engine supports a variety of operating systems and versions. This section describes the 
platforms that we ensure the engine runs on without issue (although in some cases with reduced 
functionality). 


Windows 
LiveCode supports the following versions of Windows: 


e Windows XP SP2 and above 

e Windows Server 2003 

e Windows Vista SP1 and above (both 32-bit and 64-bit) 
e Windows 7 (both 32-bit and 64-bit) 

e Windows Server 2008 

e Windows 8.x (Desktop) 

e Windows 10 


Note: On 64-bit Windows installations, LiveCode runs as a 32-bit application through the WoW 
layer. 
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Linux 


LiveCode supports the following Linux distributions, on 32-bit or 64-bit Intel/AMD or compatible 
processors: 


e Ubuntu 14.04 and 16.04 

e Fedora 23 & 24 

e Debian 7 (Wheezy) and 8 (Jessie) [server] 
e CentOS 7 [server] 


LiveCode may also run on Linux installations which meet the following requirements: 
e Required dependencies for core functionality: 


o glibc 2.13 or later 
o glib 2.0 or later 


e Optional requirements for GUI functionality: 


°0 GTK/GDK 2.24 or later 

o Pango with Xft support 

°o esd (optional, needed for audio output) 

o mplayer (optional, needed for media player functionality) 

© Icms (optional, required for color profile support in images) 
© gksu (optional, required for privilege elevation support) 


Note: If the optional requirements are not present then LiveCode will still run but the specified 
features will be disabled. 


Note: The requirements for GUI functionality are also required by Firefox and Chrome, so if your 
Linux distribution runs one of those, it will run LiveCode. 


Note: It may be possible to compile and run LiveCode Community for Linux on other 
architectures but this is not officially supported. 


Mac 
The Mac engine supports: 


e 10.6.x (Snow Leopard) on Intel 
e 10.7.x (Lion) on Intel 

e 10.8.x (Mountain Lion) on Intel 
e 10.9.x (Mavericks) on Intel 

e 10.10.x (Yosemite) on Intel 

e 10.11.x (El Capitan) on Intel 

e 10.12.x (Sierra) on Intel 


iOS 
iOS deployment is possible when running LiveCode IDE on a Mac, and provided Xcode is installed 
and has been set in LiveCode Preferences (in the Mobile Support pane). 
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Currently, the supported versions of Xcode are: 


e Xcode 4.6 on MacOS X 10.7 

e Xcode 5.1 on MacOS X 10.8 

e Xcode 6.2 on MacOS X 10.9 

e Xcode 6.2 and 7.2 on Mac OS X 10.10 
e Xcode 8.1 on MacOS X 10.11 

e Xcode 8.1 on MacOS 10.12 


It is also possible to set other versions of Xcode, to allow testing on a wider range of iOS 
simulators. For instance, on OS X 10.10 (Yosemite), you can add Xcode 5.1 in the Mobile Support 
preferences, to let you test your stack on the /OS Simulator 7.1. 


We currently support deployment for the following versions of iOS: 


e 6.1 [simulator] 
e 7.1 [simulator] 
e 8.2 [simulator] 
e 9.2 

e 10.1 


Android 


LiveCode allows you to save your stack as an Android application, and also to deploy it on an 
Android device or simulator from the IDE. 


Android deployment is possible from Windows, Linux and Mac OSX. 


The Android engine supports devices using ARMv6, ARMv7 or ARMV8 processors. It will run on the 
following versions of Android: 


e 2.3.3-2.3.7 (Gingerbread) 
e 4.0 (Ice Cream Sandwich) 
e 4.1-4.3 (Jelly Bean) 

e 4.4 (KitKat) 

e 5.0-5.1 (Lollipop) 

e 6.0 (Marshmallow) 


To enable deployment to Android devices, you need to download the Android SDK, and then use 
the 'Android SDK Manager' to install: 


e the latest "Android SDK Tools" 
e the latest "Android SDK Platform Tools" 


You also need to install the Java Development Kit (JDK). On Linux, this usually packaged as 
"openjdk". LiveCode requires JDK version 1.6 or later. 


Once you have set the path of your Android SDK in the "Mobile Support" section of the LiveCode 
IDE's preferences, you can deploy your stack to Android devices. 


Some users have reported successful Android Watch deployment, but it is not officially supported. 
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HTML5 


LiveCode applications can be deployed to run in a web browser, by running the LiveCode engine in 
JavaScript and using modern HTML5 JavaScript APIs. 


HTML5 deployment does not require any additional development tools to be installed. 


LiveCode HTML5 standalone applications are currently supported for running in recent versions of 
Mozilla Firefox, Google Chrome or Safari. For more information, please see the "HTML5 
Deployment" guide in the LiveCode IDE. 
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Installation 


Each version of LiveCode installs can be installed to its own, separate folder. This allow multiple 
versions of LiveCode to be installed side-by-side. On Windows (and Linux), each version of 
LiveCode has its own Start Menu (or application menu) entry. On Mac OS X, each version has its 
own app bundle. 


On Mac OS X, install LiveCode by mounting the .dmg file and dragging the app bundle to the 
Applications folder (or any other suitable location). 


For Windows and Linux, the default installation locations when installing for "All Users" are: 


Platform Path 
Windows <x86 program files folder>/RunRev/LiveCode <version> 


Linux /opt/livecode/livecode-<version> 


The installations when installing for "This User" are: 


Platform Path 
i RunR itesy/ let 
Windows <user roaming app data folder>/RunRev/Components/LiveCode 
<version> 
Linux ~/.runrev/components/livecode-<version> 


Note: If installing for "All Users" on Linux, either the gksu tool must be available, or you must 
manually run the LiveCode installer executable as root (e.g. using sudo or su). 


Uninstallation 


On Windows, the installer hooks into the standard Windows uninstall mechanism. This is accessible 
from the "Add or Remove Programs" applet in the windows Control Panel. 


On Mac OS X, drag the app bundle to the Trash. 


On Linux, LiveCode can be removed using the setup.x86 or setup.x86 64 program located in 
LiveCode's installation directory. 
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Reporting installer issues 


If you find that the installer fails to work for you then please report it using the LiveCode Quality 
Control Centre or by emailing support@livecode.com. 


Please include the following information in your report: 


e Your platform and operating system version 

e The location of your home or user folder 

e The type of user account you are using (guest, restricted, admin etc.) 
e The installer log file. 


The installer log file can be located as follows: 


Platform Path 
Windows 2000/XP <documents and settings folder>/<user>/Local Settings/ 
Windows Vista/7 <users folder>/<user>/AppData/Local/RunRev/Logs 


Linux <home>/.runrev/logs 


Activating LiveCode Indy or Business edition 


The licensing system ties your product licenses to a customer account system, meaning that you 
no longer have to worry about finding a license key after installing a new copy of LiveCode. 
Instead, you simply have to enter your email address and password that has been registered with 
our customer account system and your license key will be retrieved automatically. 


Alternatively it is possible to activate the product via the use of a specially encrypted license file. 
These will be available for download from the customer center after logging into your account. This 
method will allow the product to be installed on machines that do not have access to the internet. 


Command-line installation 


It is possible to invoke the installer from the command-line on Linux and Windows. When doing 
command-line installation, no GUI will be displayed. The installation process is controlled by 
arguments passed to the installer. 


Run the installer using a command in the form: 


<installer> install noui [OPTION ...] 


where <installer> should be replaced with the path of the installer executable or app (inside 
the DMG) that has been downloaded. The result of the installation operation will be written to the 
console. 


The installer understands any of the following OPTIONs: 


Option Description 
Install the IDE for "All Users". If not specified, LiveCode will be installed 
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-al lGption for the current user only. Description 

: PI hortcut on the Desktop (Wi -onl 

deskronshortcut ace a shortcut on the Desktop (Windows-only) 

-startmenu Place shortcuts in the Start Menu (Windows-only) 

- location The folder to install into. If not specified, the LOCATION defaults to those 

LOCATION described in the "Installation" section above. 

Siognloceine The file to which to log installation actions. If not specified, no log is 
generated. 


Note: the command-line installer does not do any authentication. When installing for "All Users", 
you will need to run the installer command as an administrator. 


As the installer is actually a GUI application, it needs to be run slightly differently from other 
command-line programs. 


On Windows, the command is: 


start /wait <installer> install noui [OPTION ...] 


Command-line uninstallation 


It is possible to uninstall LiveCode from the command-line on Windows and Linux. When doing 
command-line uninstallation, no GUI will be displayed. 


Run the uninstaller using a command of the form: 
<uninstaller> uninstall noui 


Where is .setup.exe on Windows, and .setup.x86 on Linux. This executable, for both of the 
platforms, is located in the folder where LiveCode is installed. 


The result of the uninstallation operation will be written to the console. 


Note: the command-line uninstaller does not do any authentication. When removing a version of 
LiveCode installed for "All Users", you will need to run the uninstaller command as an 
administrator. 


Command-line activation for LiveCode Indy or Business edition 


It is possible to activate an installation of LiveCode for all users by using the command-line. When 
performing command-line activation, no GUI is displayed. Activation is controlled by passing 
command-line arguments to LiveCode. 


Activate LiveCode using a command of the form: 


<livecode> activate -file LICENSEFILE -passphrase SECRET 
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where <lLivecode> should be replaced with the path to the LiveCode executable or app that has 
been previously installed. 


This loads license information from the manual activation file LICENSEFILE, decrypts it using the 
given SECRET passphrase, and installs a license file for all users of the computer. Manual 


activation files can be downloaded from the My Products page in the LiveCode account 
management site. 


It is also possible to deactivate LiveCode with: 

<livecode> deactivate 

Since LiveCode is actually a GUI application, it needs to be run slightly differently from other 
command-line programs. 

On Windows, the command is: 


start /wait <livecode> activate -file LICENSE -passphrase SECRET 
start /wait <livecode> deactivate 


On Mac OS X, you need to do: 


<livecode>/Contents/MacOS/LiveCode activate -file LICENSE -passphrase SECRET 
<livecode>/Contents/MacOS/LiveCode deactivate 


aletial= lalet= 


Improved ul_TraceLocals output (8.1.2-rc-1) 


The ul_TraceLocals function in revLibURL has been improved so that it prints out keys and values 
of the script local arrays in the library. This is useful for troubleshooting libDURL issues. 


Fix problems with printing PDFs to some printers (8.1.2-rc-1) 


It was possible for LiveCode to generate PDFs which were incompatible with some printers. This 
has been fixed by upgrading the PDF generation library which LiveCode uses (cairo). 


Specific engine bug fixes (8.1.2-rc-3) 


18900 Fix acrash when closing a stack with substacks still open 

18911 Fix graphical artefacts when reshaping polygon graphics while selected 

Make sure our prebuilt libs do not use reserved (by Apple private APIs) function 
names 


18958 


18962 
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Fix crash when using field 


Specific engine bug fixes (8.1.2-rc-2) 


18484 
18809 
18810 
18812 
18823 
18824 
18863 


Prevent mobilePlaySoundOnChannel crash on Android 

Prevent lock up of PI when not selecting choice from font menu 

Fix a crash when cutting controls 

Fix crash when opening cards referencing images on non-open cards 
Fix a crash when popping up transient windows 

Fix a crash when drag-selecting controls 

Fix encrypt/decrypt operations broken by the OpenSSL 1.1.0 update 


Specific engine bug fixes (8.1.2-rc-1) 


15384 
16965 


17008 
17247 
17541 
17622 
17779 
18275 
18287 
18293 


18343 


18349 
18379 
18406 
18440 


18441 


18444 
18472 
18473 
18488 
18496 
18498 
18499 
18521 
18536 
18566 
18578 


Fix incorrect handling of a 204 response from a server. 

Fix incorrect placement of browser widget after stack rect change when 
fullscreenmode used. 

Fix selection handles remaining after selected object deleted 

Remove selection artefacts when handles are drawn outside of parent group rect 
Fix problems with printing PDFs to some printers 

Fix extra data added on Windows when pasting html data from the clipboard 

Fix scrolling group drawing outside its bounds when acceleratedRendering used. 
Enable sqlite FTS5 feature 

Update sqlite version to 3.15.0 

Crash when deleting a stack that is used as a popup menu 

Fix incorrect result from itemOffset when first character of stringToSearch is the 
delimiter 

Fix variable contents modified when used to set stack name 

Don't include incorrectly copied resource forks in standalones 

Fix delay in triggering handlers when called by JavaScript in browser widget 
Respect SB Copy Files pane relative / absolute path distinction on mobile 

Make sure the purchaseStateUpdate callback is sent with status=complete when 
necessary 

Make sure put cookie with empty value works as expected 

‘load url' is not properly cleaned up on socketError 

Prevent hang when adjusting field pixmap offset 

Error returned by hostnametoaddress was not being reported in JibURL. 

Fix memory leak when using filter on unicode strings 

Ensure bundled Android externals are available on Windows and Linux 

Fix libUrlISetStatusCallback on mobile platforms when tsNet is in use 

Resolve folder path before processing files(folder) and folders(folder) 

Added support for Xcode 8.1 / iOS 10.1 

libURL inserts "::" between host and port when creating CONNECT request 
Ensure color name rgb value mapping is in alphabetical order 


18604 
18614 
18623 
18625 
18626 
18642 
18653 
18683 
18690 
18691 


18703 
18709 
18783 
6506 
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Fix crash when converting objective-c objects to LiveCode values 

Fix Linux player crash when accessing properties 

Remove tsneterr: from the start of output of tsNetVersion() 

Fix browser javascripthandlers not working on iOS after loading a new page 
Make sure the Standalone Application Settings on Windows are respected 
Fixed crash on iOS 10 when trying to read local notifications 

Encode bundle display name as utf-8 in ios app plist 

Fix crash on iOS 10 when the app needs access to the device's microphone 
Provide mergExt Builds for building against iOS 10.1 SDK 

Provide tsNet Builds for building against iOS 10.1 SDK 

Fix handling of new tsNet network requests when an existing network request is still 
waiting to connect 

Cannot deploy an app to iOS 10.1 simulator 

Resolve delay in opening Windows standalones that include tsNet 1.2.4 and the 
Internet inclusion 

Fix regression to watching global variables 


Specific IDE bug fixes (8.1.2-rc-2) 


18857 


Import as control > Text file doesn't set text of control 


Specific IDE bug fixes (8.1.2-rc-1) 


17447 
17536 
17618 
18029 
18290 
18292 
18300 
18452 
18455 
18460 
18483 
18557 
18721 
18791 


Reinstate resize checkbox in property inspector Position pane 

Fix or mitigate effect of nudging many controls at once 

Reinstate ‘fit content' button in property inspector Position pane 

Show 20 fonts at a time in property inspector font menu 

Use datagrid template safely while building custom headers 

Fix hidden palettes not reappearing 

property inspector custom property list is not sorted 

Saving a substack from the Project Browser no longer asks for a path to save 
Show the correct version of LiveCode in Start Center title 

Mark stack as edited when property changed from the Pl 

Prevent iOS display name standalone setting becoming utf-8 encoded data 
Ensure dragging object from tools palette is smooth 

Make sure unchecking "Notify me of development releases" is respected 
Fix PI list editors not updating when value changed 


LiveCode extension changes 


Specific extension bug fixes (8.1.2-rc-1) 


10 
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18319 Prevent segmented control fill from bleeding outside border. 


18391 Correctly order default marker styles 
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